Хелперы для плагина "Бренды PRO"
В данной инструкции представлены "хелперы", или специальные конструкции для получения информации из плагина "Бренды PRO". В первую очередь они предназначены для технических специалистов, обладающих знаниями вёрстки или доработки магазинов на Shop-script. Пожалуйста, имейте в виду, что примеры вывода представлены в упрощённом виде, не используйте их в таком формате на своём сайте.
Хелперы работают при их использовании:
- в шаблонах темы дизайна
- в описании товаров
- в описании категорий
- на информационных страницах, созданных в приложении "Магазин"
Хелперы не работают:
- на информационных страницах, созданных в приложении "Сайт".
Получить бренд по ID:
{shopBrandViewHelper::getBrand($brand_id)}
$brand_id в данном случае это внутренний индентификатор бренда в плагине. Посмотреть его можно в URL при редактировании бренда
Пример получения информации:
{$product_brand = shopBrandViewHelper::getBrand(131)}
Получаемые данные:
- $product_brand['id']
- $product_brand['name']
- $product_brand['url']
- $product_brand['image']
- $product_brand['description_short']
- $product_brand['product_sort']
- $product_brand['filter']['is_shown']
- $product_brand['filter']['enable_client_sorting']
- $product_brand['filter']['empty_page_response_mode']
- $product_brand['filter']['sort']
Вывод брендов товара (продукта)
{shopBrandViewHelper::getProductBrand($product)}
Вывод всех брендов
{shopBrandViewHelper::getAllBrands()}
Вывод всех брендов с изображениями (с версии 1.1):
{shopBrandViewHelper::getAllBrandsWithImages()}
Получить картинки бренда определенного размера
{$brand->getImageUrl('970')}
Получение списка брендов с товарами в наличии (c версии 1.20.0)
{shopBrandViewHelper::getBrandsWithProducts}
NEW (c версии 1.17.0):
Получить информацию бренда в карточке товара
{shopBrandViewHelper::getBrandMainPage($product)}
Например, для вывода описания бренда и доп. описания:
{$brand_page = shopBrandViewHelper::getBrandMainPage($product)}
{$brand_page.description}
{$brand_page.additional_description}
Получение списка брендов, сгруппированных по алфавиту
Хелпер:
{shopBrandViewHelper::getGroupedBrands()}
Пример получения информации
{$alphabet_brands = shopBrandViewHelper::getGroupedBrands()}
{foreach $alphabet_brands as $letter => $alphabet_brand}
{$letter}
{foreach $alphabet_brand['brands'] as $a_brand}
<a href=" {$a_brand['url']}"> {$a_brand['name']}</a>
{/foreach}
{/foreach}
Получаемые данные:
Array => (
*буква бренда* => (
'link' => *ссылка на якорь буквы в списке всех брендов*,
'brands' => (
'id' => ,
'name' => ,
'url' => ,
'image' => ,
'description_short' => ,
'product_sort' => ,
'filter' => (
'is_shown' => ,
'enable_client_sorting' => ,
'empty_page_response_mode' => ,
'sort' =>
)
)
)
)
Вывод шаблона меню брендов, сгруппированных по алфавиту
{shopBrandViewHelper::showGroupedBrands()}
Редактирование файла шаблона доступно в настройках плагина
Примеры использования хелперов
1. Вывод картинки-ссылки на бренд в карточке товара
{$product_brand = shopBrandViewHelper::getProductBrand($product)}
{if $product_brand}
<a href="{$product_brand.frontend_url}">
{if $product_brand.image_url}
<img src="{$product_brand.image_url}" alt="{$product_brand.name|escape}">
{else}
<span>{$product_brand.name|escape}</span>
{/if}
</a>
{/if}
2. Вывод ссылок на все бренды
{foreach shopBrandViewHelper::getAllBrands() as $brand}
<a href="{$brand.frontend_url}">{$brand.name|escape}</a>
{/foreach}